home *** CD-ROM | disk | FTP | other *** search
/ ADA Programming Guide / ADA Programming Guide.iso / ada_gnu / readme.1st < prev    next >
Text File  |  1996-01-30  |  10KB  |  214 lines

  1. This is djgpp's README.1ST, which you should have read before any other. 
  2. Please read this COMPLETELY before going any further. 
  3.  
  4. WARNING: This software comes with ABSOLUTELY NO WARRANTEE.  I can't even
  5. guarantee that this software won't wipe out your entire hard drive (it's
  6. happened to a few people before, but we've fixed it).  USE AT YOUR OWN
  7. RISK! It's always a good idea to make regular backups of your hard
  8. drives anyway. 
  9.  
  10. If you are installing djgpp off floppies, you should run the install
  11. program on disk 1.  This program will prompt you for all the information
  12. it needs to properly install djgpp on your system. 
  13.  
  14. If you are using PKUNZIP to extract your files, don't forget the -d or
  15. you'll get them all in the same directory! All djgpp modules are
  16. designed to be unzipped from the same directory, so that they install
  17. themselves properly.  You should also use the -o switch, since some
  18. files are included in multiple modules. 
  19.  
  20. You will need either PKUNZIP version 2 or higher, or InfoZip's unzip
  21. version 5.0 or higher.  A complementary copy of InfoZip's unzip is
  22. provided as UNZIP386.EXE in case you don't have either.  This file
  23. uses a merged copy of go32.exe, so you should re-stub it once you have
  24. go32 installed to save disk space.  For information on getting
  25. Info-Zip's zip and unzip programs, see the info blurb at the end of
  26. this file.
  27.  
  28. You should be able to find documentation in various subdirectories of
  29. the docs directory in the djgpp distribution.  The files README and FAQ
  30. are in the djdocXXX.zip module.  If you install txiXXXbn.zip, you can
  31. run "info" to read this documentation. 
  32.  
  33. The modules you'll want to start with are (replace XXX with an
  34. appropriate version number):
  35.  
  36.  djdocXXX.zip  The base documentation
  37.  djeoeXXX.zip  Execution-only environment - extender binary, emu387,
  38.                some utils, README and FAQ
  39.  djdevXXX.zip  Basic development libraries and utilities
  40.  gccXXXbn.zip  GCC binaries, including C front end (no C++ or ObjC)
  41.  gasXXXbn.zip  Assembler - required for all compiles
  42.  bnuXXXbn.zip  Binary utilities - required for all compiles
  43.  
  44.  djXXXmX.zip   Maintainance releases - install LAST and IN ORDER.
  45.  
  46. Don't forget to use the "-o" switch on unzip, as some files are
  47. replicated throughout all the modules.  The command should look like
  48. this example:
  49.  
  50.     unzip386 -o a:djeoe112.zip
  51.  
  52. The EOE module is for people who only need the extender (go32) to run
  53. some other 32-bit program that didn't come with one.  The remainder
  54. of these modules listed above are required to compile C programs.
  55.  
  56. For more information on installing and setting up djgpp, refer to the
  57. file docs/djgpp/readme.doc after you install
  58.  
  59. Additional modules include:
  60.  
  61.  djemuXXX.zip  80387 emulator sources
  62.  djlgrXXX.zip  Basic 256-color SVGA library (grx is better)
  63.  djsrcXXX.zip  Sources to extender and utilities
  64.  djlsrXXX.zip  Sources to all the libraries
  65.  djtstXXX.zip  Test programs to test djgpp
  66.  
  67.  makXXXbn.zip  GNU Make
  68.  gppXXX.zip    C++ front end, headers, and libraries
  69.  objcXXX.zip   Objective-C front end, headers, and libraries
  70.  bsnXXXbn.zip  Bison (yacc-like parser)
  71.  flxXXXbn.zip  Flex (lex-like parser)
  72.  txiXXXbn.zip  On-line info reader INFO.EXE and info compiler
  73.  gzpXXXbn.zip  GZip compressor
  74.  
  75. GNU programs are normally distributed as three files:
  76.  
  77.  *bn.zip       Binaries for various GNU programs
  78.  *dc.zip       Documentation for various GNU programs
  79.  *sr.zip       Sources for various GNU programs (may be split
  80.                into *s1.zip...*sN.zip)
  81.  
  82.  
  83. djgpp is a complete 32-bit C and C++ development environment for DOS. 
  84. This product is intended for users who have experience using Unix, not
  85. DOS users who expect djgpp to act like any other DOS compiler.  This is
  86. NOT the software you want if you want to learn programming. 
  87.  
  88. Supported: 80386, 80387, 80486, XMS, himem.sys, VCPI, QEMM, 386MAX,
  89. DesqView, Windows, OS/2, interrupts.
  90.  
  91. Unsupported: XTs, 80286, multitasking, signals.
  92.  
  93. Features: 80387 emulator, 32-bit unix-ish environment, flat memory
  94. model, debugger, SVGA graphics.
  95.  
  96.     ====================  Reporting bugs  ====================
  97.  
  98. ALL changes to the source code should be submitted in "diff -c2" format. 
  99. If you just send replacement files, I'll reject them, since I don't know
  100. which parts you've changed and my sources keep changing anyway.  Diffs
  101. will also be rejected for use of bcc features in go32 sources (like //
  102. comments), or more than one feature or bugfix per diff.  Please use the
  103. same programming style as the existing style when making changes to my
  104. sources. 
  105.  
  106. Note that new features are not bugs.  If you would like to work on
  107. adding features to djgpp, please send me e-mail at dj@ctron.com
  108. beforehand, in case it's being worked on already and to coordinate it's
  109. integration.  If you want to request a new feature but not work on it,
  110. send to the mailing list. 
  111.  
  112. If the problem is in one of the FSF utilities, please don't expect me to
  113. fix it.  Problems with FSF code should be reported to the FSF; I only
  114. compile the code and distribute it.  My best suggestion is to post to
  115. the appropriate newsgroup or mailing list, but if you can't find one,
  116. ask gnu@prep.ai.mit.edu. 
  117.  
  118. If the problem is in anything else, and you have e-mail access, I strongly
  119. recommend joining the djgpp mailing list.  To do so, send mail to
  120. listserv@sun.soe.clarkson.edu:
  121.  
  122.     $ mail listserv@sun.soe.clarkson.edu
  123.     Subject:
  124.     help
  125.     add <e-mail address> djgpp
  126.     ^D
  127.  
  128. Any mail sent to djgpp@sun.soe.clarkson.edu will get automatically
  129. forwarded to all the subscribers on the list, and someone may have an
  130. answer to your query.  Note that I (DJ) am of course a subscriber, so I
  131. will get it also. 
  132.  
  133. If all else fails, you may contact me directly at dj@ctron.com
  134. (preferred) or at home:
  135.  
  136.     DJ Delorie
  137.     24 Kirsten Ave
  138.     Rochester, NH 03867-2954
  139.     USA
  140.  
  141. If you write, please include a stamped, self-addressed envelope.  The
  142. FSF (see README for address) sells djgpp on floppies, as do I.  If you
  143. would like a complete set of djgpp floppies from me, send a check or
  144. money order (made out to DJ Delorie) in the amount of US$100 to the
  145. address above.  Please specify 1.4M or 1.2M floppies, and allow a few
  146. weeks for processing and shipping.  You will automatically be registered
  147. for update notices and reduced prices on future versions.  To be added
  148. to the mailing list for new version notices ONLY, please send US$5 to
  149. the address above. 
  150.  
  151. All phone calls will be returned collect.  Please leave a night/weekend
  152. phone number. 
  153.  
  154.     ====================  Redistribution  ====================
  155.  
  156. The utilities built from FSF code may NOT be made available through any
  157. means not prepared to also distribute the source for those utilities. 
  158. This isn't just a good idea, it's the LAW.  Read the file "copying" for
  159. more details on FSF copyright terms.  Since djgpp includes such
  160. binaries, it requires the same terms. 
  161.  
  162. Programs that link in FSF code must comply with the GNU Library Public
  163. License, or the GNU General Public License.  All FSF objects are in
  164. libgpl.a and libgpp.a
  165.  
  166. I strongly recommend prepending stub.exe (use coff2exe) for any programs
  167. you intend to distribute.  This aids upgrading go32, since stub.exe
  168. doesn't need to change, and coff2exe produces a faster executable due to
  169. disk alignment optimizations. 
  170.  
  171.  
  172. ===== Info-Zip =====
  173.  
  174. (extract from Info-Zip's "where" file used with permission)
  175.  
  176. ftp sites for the US-exportable sources and executables:
  177.  
  178.    NOTE:  Look for the file names given above in the following directories.
  179.    Some sites like to use slightly different names, such as zip-2.0.1.tar.gz
  180.    instead of zip201.tar.Z.  In the case of some comp.sources.misc archive
  181.    sites, directories may be used (zip201/part01.Z, ..., zip201/part11.Z,
  182.    zip201/patch01.Z, etc.).
  183.  
  184.    ftp.uu.net:/pub/archiving/zip        [THIS MIRRORS THE INFO-ZIP HOME SITE]
  185.  
  186.    oak.oakland.edu:/pub/msdos/{zip,windows3}       [AND OTHER SIMTEL MIRRORS]
  187.    oak.oakland.edu:/pub/misc/{unix,vaxvms}
  188.    garbo.uwasa.fi:/{unix,pc}/arcers                 [AND OTHER GARBO MIRRORS]
  189.    ftp-os2.cdrom.com:/pub/os2/{2_x,all}/archiver
  190.    ftp-os2.nmsu.edu:/os2/{2_x,all}/archiver
  191.    ftp.informatik.tu-muenchen.de:/pub/comp/os/os2/archiver
  192.    sumex-aim.stanford.edu:/info-mac/util
  193.    ftp.wustl.edu:/pub/aminet/util/arc              [AND OTHER AMINET MIRRORS]
  194.    atari.archive.umich.edu:/pub/Archivers (?)       [AND OTHER UMICH MIRRORS]
  195.    lpuds.oea.ihep.su:/ ... ?
  196.  
  197. Bulletin boards (commercial and otherwise):
  198.  
  199.    Sources, MS-DOS executables:
  200.       CompuServe IBMPRO forum, Library 10, Data Compression (unz512.zip,
  201.          sources; unz512.exe, self-extracting executables and docs)
  202.       CompuServe (ZiffNet) PBSUTIL forum and Public Brand Software BBS
  203.          [US, membership required; V.32 line, (317) 856-1490]
  204.          (unz512.zip, sources; unz512.exe, self-extracting exes and docs)
  205.       FidoNet node 1:124/2113, Lunatic Fringe [Richardson, Texas; BBS
  206.          (214) 235-5288; sysop john.stewart@lunatic.com; complete mirror
  207.          of Info-ZIP home site]
  208.       FidoNet node 1:246/74, Metal Shoppe BBS [Windsor, Ontario; CLink
  209.          node 911:6510/0; BBS (519) 256-0278; sysop rakey@cyberspace.net
  210.          (Ray Akey); micro-based files but no Unix/VMS/NT stuff]
  211.       Drealm Conference System [London, UK; V.22bis, subscriber lines
  212.          to V.32bis, etc.; (+44) 81 568 2204]
  213.       Compulink Information eXchange (CIX) [UK ... details?]
  214.